package com.example.forum.services;

import com.example.forum.model.Article;
import io.swagger.v3.oas.annotations.servers.Server;
import org.apache.ibatis.annotations.Param;
import org.springframework.stereotype.Service;
import org.springframework.transaction.annotation.Transactional;

import java.util.List;

/**
 * Created with IntelliJ IDEA.
 * Description:
 * User: Lily
 * Date: 2024-10-10
 * Time: 11:55
 */
public interface IArticleService {
    /**
     * 新增帖⼦
     * @param article 帖⼦信息
     */
    // 事务管理
    @Transactional
    void create(Article article);

    /**
     * 主⻚中显⽰的帖⼦列表以发布时间降序排列
     *
     * @return 帖⼦列表
     */
    List<Article> selectAll ();

    /**
     * 根据版块Id查询所有帖子列表
     * @param boardId 版块Id
     * @return
     */
    List<Article> selectAllByBoardId ( Long boardId);


    /**
     * 根据帖子Id查询详情
     * @param id 帖子Id
     * @return 帖子详情
     */
    Article selectDetailById (Long id);


    /**
     * 编辑帖子
     * @param id 帖子Id
     * @param title 帖子标题
     * @param content 帖子正文
     */
    void modify (Long id, String title, String content);

    /**
     * 根据帖子Id查询记录
     * @param id 帖子Id
     * @return
     */
    Article selectById (Long id);

    /**
     * 点赞帖子
     * @param id 帖子Id
     */
    void thumbsUpById (Long id);

    /**
     * 根据Id删除帖子
     * @param id 帖子Id
     */
    @Transactional // 事务管理
    void deleteById (Long id);

    /**
     * 文章回复数量 +1
     * @param id 版块Id
     */
    void addOneReplyCountById (Long id);

    /**
     * 根据用户Id查询帖子列表
     * @param userId 用户Id
     * @return 帖子列表
     */
    List<Article> selectByUserId (@Param("userId") Long userId);
}
